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一 起 学 koa 


作者 : 17koa 
来 源 : koa-generator-examples 


koa 是 下 一 代 基 于 nodejs 的 modern web framework， 会 用 到 很 多 es 高 级 特性 ， 可 以 
说 无 论 从 eS 学习 还 是 Web 开 发 都 有 必要 学 习 。 


鉴于 目前 学 习 资 料 不 多 ， 故 有 此 书 
年 前 几 天 比较 忙 ， 更 新 暂缓 
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大 家 一 起 学 习 koa 


e 暂时 不 会 的 可 以 学 会 
e 会 的 可 以 帮助 他 人 ， 查 缺 补 漏 ， 提 供 更 多 最 佳 实践 


参与 流程 


通过 提问 、 实 现 ，pr 的 方式 


提 issue 

根据 某 个 issue，fork 并 实现 
提交 pr 

合并 pr 并 提交 

发 布 到 git pages 上 


版 本 说 明 


A Koa 2.x 还 没有 发 布 ， 先 以 Koa 1.x 为 主 


koajs 1.x 和 2.x 的 区 别 


1.x 和 2.x 的 都 是 基于 ctx (上 下 文 ) 模型 实现 的 
目前 2.x 还 没 没 有 完全 定 下 来 


e nodejs 4.0+ 支 持 的 es6 语 法 
e async/await 支 持 (现在 须 借 由 babel) 
e generator 不 能 直接 使 用 ， 必 须 使 用 co 类 的 包装 后 才 可 以 


Hx 


e koa zk ah 
o 上 下 文 
e koa-generator 
o 安装 
o 创建 项 目 
o 切换 视图 模板 引擎 
o 路 由 
e HTTP 
o Get 请 求 
m 如 何 获取 query 参 数 
m 如 何 获取 params 
o Post 请 求 
= 从 post 获 取 参 数 
a 标准 表单 (Post with x-www-form-urlencoded) 
m 文件 上 传 (Post with form-data) 
m Post with raw 
e 数据 库 
o MySQL 
o Mongo 
e 流程 控制 
o generator/co 
m eS6 的 generator 是 什么 ? 
m CO = generator + promise 
o async/await 
o promise with bluebird 


e 测试 
o Mocha 
o supertest 

e SÍ 

e 最 佳 实践 

e FAQ 

e 一 起 学 koa 之 1.x 版 本 预览 
e 一 起 学 koa 之 2.x 版 本 预览 


技术 顾问 


e @fundon 
e @alsotang 
e 0% 


用 明白 不 一 定 写 明 白 ， 但 写 明 白 就 一 定 能 用 明白 ， 大 家 加 油 


Contributing 

1. Fork it 

2. Create your feature branch ( git checkout -b my-new-feature ) 
3. Commit your changes ( git commit -am 'Add some feature' ) 
4. Push to the branch ( git push origin my-new-feature ) 

5. Create new Pull Request 


Version History 


e v0.1.0 初始 化 版 本 


欢迎 fork 和 反馈 
如 有 建议 或 意见 ， 请 在 issue 提 问 或 邮件 


当然 也 可 以 在 国内 最 专业 的 cnode 论 坛 上 回复 《一 起 学 koa》 


License 


this repo is released under the MIT License. 


Nodejs 4.x 


关于 node 各 版 本 解释 


最 近 node 官 网 发 布 了 更 新 日 志 Node v5.1.1 (Stable), v4.2.3 "Argon" (LTS), v0.12.9 
(LTS) and v0.10.41 (Maintenance) are released 请 问 这 些 版 本 有 什么 区 别 ， 适 用 于 
什么 场景 ， 我 发 现 node 官 方 提 供 下 载 的 是 4.2.3 和 5.1.1， 但 yum 安装 的 是 0.10.41 
网 上 搜 了 下 没 找 到 答案 ， 只 能 靠 cnode 社 区 啦 ~ 多 谢 | 


e Stable 是 当前 稳定 版 本 
e。LTS 是 长 期 支持 版 本 
e Maintenance 是 维护 ， 不 再 增加 任何 feature， 仅 做 重大 bug 修 复 


Why use 4.x? 


目前 4.2.* 是 LTS (长 期 支持 版 本 ) ， 支 持 非 常 多 的 es6 特 性 ， 这 些 都 是 koa 的 基石 ， 
可 以 让 大 家 更 好 的 利用 es6 开 发 modern web app ° 


新 特性 


Node.js 4.0.0 可 以 让 您 享受 最 尖端 的 技术 ， 保 持 项 目的 先进 性 。 其 中 对 v8 的 升级 
几乎 做 到 了 与 Chromium / Google Chrome 同步 ， 达 到 了 4.5.x， 它 提供 了 很 多 新 
的 语言 功能 。ECMA-262 是 JavaScript 语言 规范 的 最 新 版 本 ， 而 且 好 多 新 特性 数 者 
是 开 箱 即 用 的 。 这 些 新 特性 包括 : 


e classes - 各 种 XL” > HALA RA CoffeeScript 的 语法 糖 写 类 了 

e typed arrays 一 类 型 数组 

generators - 未 来 的 .js 代码 中 将 有 无 数 生成 器 ， 不 学 一 点 就 看 不 懂 JS 代码 了 
哦 

collections 一 集合 、 映 射 、 弱 集合 、 弱 映射 

arrow functions — 箭 向 函数 

block scoping 一 使 用 let > const 作用 域 ， 块 辖 域 

template strings 一 模板 字 串 

promises 一 用 标准 化 了 的 方法 进行 延迟 和 异步 计算 

symbols 一 唯一 的 、 不 可 修改 的 数据 


下 面 会 逐一 讲解 


classes 


在 ES6 中 声明 一 个 class 


在 ES6 中 ， 你 可 以 使 用 如 下 的 方式 进行 Class 声 明 。 在 使 用 的 过 程 中 ， 有 一 点 需要 特 
别 注 意 ， 一 定 要 先 使 用 下 面 的 任何 一 种 方式 声明 的 class， 才 能 引用 class 定 义 。 这 
个 和 原先 的 JavaScript prototype 方 式 声 明 有 很 大 的 区 别 ， 在 原先 的 方式 中 ， 因 为 
class 是 通过 function 来 声明 的 ， 而 在 javascript 中 ，function 将 自动 变 成 全 局 可 见 ， 
所 以 class 的 定义 可 以 出 现在 引用 之 后 。 

在 后 面 的 文章 中 ， 为 了 保持 代码 的 一 致 性 和 文章 的 清晰 ， 我 们 将 只 适用 第 一 种 方式 
进行 class 定 义 


e 使 用 class 关 键 字 


class Polygon{ 


j 


* 使 用 class 表 达 式 进行 声明 


var Polygon = class { 


定义 class 的 构造 函数 


通过 使 用 constructor 关 键 字 ， 你 可 以 给 class 定 义 一 个 构造 函数 。 不 过 在 整个 
class 的 定义 中 ， 只 能 有 一 个 构造 函数 存在 .下 面 是 一 个 具体 的 例子 


class Polygon( 
constructor(height, width){ 
this.height - height; 
this.width - width; 


给 class 增 加 成 员 属 性 


在 ES6 中 ， 你 可 以 通过 getter 和 setter 方 法 ， 给 类 增加 属性 。 如 果 属 性 只 有 
getter 方 法 ， 那 么 它 就 是 一 个 只 读 属 性 ; 如 果 属 性 同时 又 setter 和 getter 方 法 ， 
那么 它 就 是 一 个 可 读 写 属性 。 请 看 下 面 的 例子 

注意 属性 name 和 _name 

因为 我 们 定义 了 name 的 读 写 器 ， 而 没有 定义 name 的 读 写 器 ， 所 以 访问 这 
两 个 属性 的 结果 是 不 同 的 。 


class Person( 


j 
me 


constructor(name){ 
this._name = name; 


get name(){ 
return this. name.toUpperCase(); 
} 


Vie 
* 注意 一 点 ， 不 要 这 样 写 : 
* set name(somename) { 
* this.name = somename; 


* 
* AA this.name 赋值 的 时 候 会 调用 set name ， 这 样 会 导致 无 限 递 归 直 
* 
25 
set name(somename) { 
this._name = somename; 


} 





class? Han HFK 


这 点 没什么 可 说 的 ， 就 是 在 类 定义 中 增加 函数 定义 即 可 ， 请 看 下 面 的 例 


class 


Polygon( 


constructor(height, width){ 


j 


this.height - height; 
this.width - width; 


get name()( 


j 


return this. name; 


set name(somename) { 


} 


this._name = somename; 


//readonly property 
get area(){ 


} 


return calcArea(); 


calcArea()( 


j 


return this.height * this.width; 


实现 class 的 继承 
在 ES6 中 ， 通 过 使 用 extends 关 键 字 ， 你 可 以 使 用 类 的 继承 


class Animalf 
constructor(name){ 
this.name = name; 


} 
say()t 
console.log(this.name + " try to say something.. 
} 
class Dog extends Animal{ 
say()t ] 
// 可 以 通过 super 关 键 字 来 调用 父 类 的 方法 
super.say(); 
console.log(this.name + " barking..."); 
} 


FAAN AA 


D 


JEESG' T. > T Ri Astatic X 4£& FRELSARI AA o FAR ARANA 
是 对 外 提供 一 些 辅助 方法 。 在 下 面 的 例子 中 ，Point 类 an 了 一 个 辅助 方法 来 


计算 2 点 间 的 XE. à 


class Point(){ 
constructor(x, y){ 
this.x X 
this.y = y; 


static distance(a, b){ 
constant dx = a.x - b.x; 
constant dy = a.y - b.y; 
return Math.sqgrt(dx ^ dx + dy * dy); 


typed arrays 


类 型 数组 


概述 


Generator 是 ES6 引 入 的 实现 异步 操作 的 一 种 新 方法 ， 在 Generator 出 现 之 前 ， 不 管 
哪 种 方法 ， 异 步 操作 都 是 使 用 回调 函数 来 实现 的 。 只 从 出 现 了 Generator 之 后 ， 开 
发 人 员 可 以 使 用 同步 调用 的 逻辑 来 实现 异步 操作 ， 只 要 在 需要 等 待 的 地 方 ， 使 用 
yieldi& 4] zx F 3S 47 Bp 9T o 
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和 学 习 所 有 其 他 语言 特性 一 样 ， 我 们 使 用 一 个 Hello World 4% A Generator& A 1] 
代码 


function* helloworld(){ 
yield "Hello"; 
return "World!"; 


j 


func - helloworld(); 


func.next();//return ( value: 'Hello', done: false } 
func.next();//return ( value: 'World!', done: true } 
func.next();//return ( value: '', done: true ) 


从 上 面 的 代码 的 输出 可 以 看 出 


e Generator AI A 3L » Ai 3d function * 实 现 的 
e 3t Generator $ 2449 39 AREA Sz RE. R KERN EN 38 25 
的 next 方 法 来 获得 函数 的 输出 
e 通过 使 用 yield 语 名 来 中 断 Generator 函 数 的 运行 ， 并 且 可 以 返回 一 个 中 间 结 果 
e. 每 次 调用 next 方 法 ，Generator 函 数 将 执行 到 下 一 个 yield 语 多 或 者 是 return 语 
各。 下 面 我 们 就 对 上 面 代码 的 每 次 next 调 用 进行 一 个 详细 的 解释 
o 第 一 次 调用 next 方 法 的 时 候 ， 函 数 执 行 到 yield "Hello" 语句 停 了 下 
来 ， 并 且 返 回 了 Hello 这 个 value， 随 同 value 返 回 的 done 属 性 表明 
Generator & žk 85 35 43 EAA ER 
o 第 二 次 调用 next 方 法 的 时 候 ， 函 数 执 行 到 return "World!" 744% 7 F 
来 ， 并 且 返 回 了 World! 这 个 value， 随 同 value 返 回 的 done 属 性 表明 
Generator & 2k 865 32 47 €, 22 25 RK 
o #=xXMAMnext7 iX8)84& > d-T Generatora Zt df CART > UH 
数 调 用 立即 返回 ，done 属 性 表明 Generator 函 数 已 经 结束 运行 ，value 是 空 
的 ， 因 为 这 次 调用 并 没有 执行 任何 语句 


yieldi& 4 


yield 语 名 在 Generator 函 数 的 执行 过 程 中 扮演 了 中 断 /暂停 执行 函数 的 功能 。 每 次 你 
调用 next() 方 法 的 时 候 ，Generator 有 函数 都 将 执行 到 下 一 个 yield 语 钨 或 者 return 语 
句 ， 当 执行 到 yield 语 和 句 的 时 候 ， 如 果 yield 语 句 跟 着 一 个 表达 式 ， 那 么 表达 式 的 值 将 


作为 value 被 返回 。 


next 方 法 参数 


由 于 yield 语 名 只 是 抛 出 value, 但 是 本 身 并 不 返回 value， 如 果 你 要 yield 语 句 有 返回 
值 ， 就 要 在 调用 next 方 法 的 时 候 ， 传 入 一 个 参数 ， 这 个 参数 就 将 作为 上 一 个 yield 语 
多 的 返回 值 ， 下 面 是 一 个 例子 


Tour Lion rt 
for(var i=0; true; i++) { 
var reset = yield i; 
if(reset) { i = -1; ) 


} 
var g = f0; 


g.next() // { value: 0, done: false } 
g.next() // { value: 1, done: false } 
g.next(true) // { value: 0, done: false } 


for...of/6§ Xf 


在 上 面 的 所 有 例子 中 ， 如 果 我 们 要 让 Generator 函 数 执行 下 一 步 ， 就 必须 调用 一 次 
next 方 法 ， 那 么 有 没有 什么 方法 让 Generator 函 数 自动 执行 每 一 步 而 不 需要 代码 干预 
呢 ? 答 案 是 肯定 的 ， 我 们 可 以 使 用 for...of 循 环 来 实现 ， 下 面 是 一 个 具体 的 例子 。 在 下 
面 的 例子 中 ，for.of loop 将 遍历 所 有 的 yield 语 句 ( 记 住 只 是 遍历 yield 语 句 ， 因 此 
return 语 名 的 返回 值 是 不 会 输出 的 ) 


function* loopThroughInt(){ 
for (let index = 0; index < 100; index++){ 
yield index; 
return 100): 


j 

for (let v of loopThroughInt())( 
console.log(v); //output 0...99 

j 


yield* 


如 果 在 Generator 有 函数 内 部 需要 调用 另外 一 个 Generator 函 数 ， 那 么 对 目标 函数 的 调 
用 就 需要 使 用 yield*， 以 下 是 一 个 简单 的 例子 


一 起 学 koa 


function* objects(){ 
yield "cat"; 
yield "dog"; 
yield "duck"; 
} 
function* say(){ 
yield* objects(); 
yield " say hello world!"; 


generators 
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在 这 个 章节 中 ， 我 们 将 介绍 ES6 中 引入 的 集合 对 象 和 映射 对 象 。 因 为 涉及 的 内 容 比 
较 多 ， 所 以 我 们 将 分 成 2 个 部 分 ， 分 别 对 集合 和 映射 对 象 进 行 介绍 。 


集合 


集合 对 象 类 似 于 以 前 JavaScript 中 的 数组 ， 只 是 集合 对 象 中 不 能 存在 相同 的 对 象 。 


集合 的 初始 
集合 对 象 是 通过 构造 函数 进行 初始 化 的 ， 调 用 格式 有 2 种 
。 不 传 参数 给 构造 函数 ， 这 将 创建 一 个 空 的 集合 对 象 


var sampleSet = new Set(); 
console.log(sampleSet.size); //will output 0 


e 传递 一 个 数组 对 象 给 构造 函数 ， 将 创建 一 个 包含 这 个 数组 中 不 重复 内 容 的 集合 


var sampleSet = new Set([1,2,3,4,5,5,6]); 
console.log(sampleSet.size);//will output 6 
console.log(sampleSet);//will ouput Set {1,2,3,4,5,6} 


向 集合 添加 内 容 
可 以 通过 使 用 集合 对 象 的 add 方 法 向 已 经 创建 的 集合 添加 新 的 内 容 


var sampleSet = new Set(); 

sampleSet.add(2); 

sampleSet.add('2'); 

console.log(sampleSet.size); //will output 2 
console.log(sampleSet); //will output Set { 2, '2' } 


//4- F2 

var sampleSet - new Set(); 

sampleSet.add(NaN); 

sampleSet.add(NaN); 

console.log(sampleSet); //will output Set { NaN } 


从 上 面 程序 的 输出 ， 可 以 看 出 


e 集合 可 以 保存 不 同类 型 的 数据 

e 在 向 集合 添加 数据 的 时 候 ，JavaScript 并 不 进行 数据 转化 。 因 此 2 和 '2' 是 不 一 样 
的 

e 对 集合 对 象 来 说 ， 所 有 的 NaN 都 是 一 样 的 


向 集合 添加 对 象 


我 们 之 所 以 将 向 集合 添加 对 象 单独 出 来 解释 ， 是 因为 对 对 象 是 否 相同 的 判断 和 普通 
对 象 不 一 样 。 下 面 是 几 个 例子 。 


//98]-F1 

var sampleSet - new Set(); 

var a = {}; 

var al = a; 

// 因 为 a 和 al 在 底层 指向 的 是 同一 个 内 存 对 象 ， 所 以 a === al 
sampleSet.add(a); 

sampleSet.add(a1); 

console.log(sampleSet); //will output Set { {} } 


//9$)-F2 

var sampleSet - new Set(); 

var a = {}; 

var al = (Y; 

// 因 为 a 和 al 在 底层 指向 的 是 不 同 的 内 存 对 象 ， 所 以 a != al 
sampleSet.add(a); 

sampleSet.add(a1); 

console.log(sampleSet); //will output Set Set ( {}, {} } 


集合 的 其 他 操作 


除了 向 已 经 存在 的 集合 添加 内 容 ， 你 还 可 以 通过 集合 的 成 员 函 数 实施 下 面 的 操作 
e 删除 内 容 ， 通 过 delete(value) 来 删除 集合 中 的 某 个 内 容 
e 判断 集合 是 否 包含 内 容 ， 通 过 has(value) 来 判断 集合 中 是 否 包 含 参数 所 指 
定 的 内 容 | | 
e 清除 所 有 内 容 ， 通 过 clear() 你 可 以 删除 一 个 集合 中 的 所 有 内 容 


集合 对 象 的 遍历 


遍历 集合 对 象 最 简单 的 方法 就 是 遍历 values() 方法 的 返回 值 ， 下 面 是 一 个 具体 的 
例子 


'use strict'; 

var sampleSet - new Set([1,2,3,4,5]); 

//output is 

Zak 

/ / 2 

ES 

//4 

/lS 

for (let val of sampleSet.values())( 
console.log(val); 


j 


遍历 集合 的 第 二 个 方法 是 条 用 forEach 函数 完成 ， 下 面 是 具体 的 例子 。 对 于 这 个 
例子 ， 大 家 一 定 很 奇怪 ， 为 什么 forEach 接 受 的 函数 的 参数 是 2 个 。 对 于 这 点 我 一 开 
始 也 觉得 很 奇怪 ， 在 看 了 相关 的 文档 才 明 白 ， 实 际 上 对 于 集合 中 的 每 个 元 素 ， 都 有 
2 个 属性 与 之 绑 定 (Key 和 value)， 只 不 过 他 们 完全 相同 而 已 ， 我 个 人 估计 是 为 了 和 
映射 对 象 保持 类 似 的 结构 ， 从 而 简化 Javascript 引 擎 而 这 么 做 的 。 


var sampleSet = new Set([1,2,3,4,5]); 
//output is 

7 / il 

I2 

//3 

//4 

/ / 

// 实 际 上 你 用 console.1og(key) 也 会 得 到 完全 一 样 的 结果 
sampleSet.forEach( (value, key) => {console.log(value);}); 
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弱 集 合 对 象 和 普通 的 集合 对 象 有 着 下 面 这 些 不 同 点 : 


e 弱 集 合 对 象 只 能 保存 对 象 ， 不 能 保存 普通 数据 

e 弱 集 合 对 象 对 另外 一 个 对 象 的 引用 ， 并 不 影响 垃圾 回收 器 的 工作 。 换 名 话说 ， 
如 果 一 个 弱 集 合 set 包含 一 个 对 象 a 的 引用 ， 如 果 在 运行 过 程 中 ， 除 了 这 个 
应 用 ， 没 有 任何 其 他 地 方 应 用 a 这 个 对 象 了 ， 那 么 垃圾 回收 器 将 回收 a 。 

e 弱 集 合 对 象 没 有 size 属性 ， 也 不 能 进行 遍历 。 不 能 进行 遍历 的 原因 就 是 因为 
第 二 点 。 因 为 在 遍历 的 过 程 中 ， 集 合 中 的 对 象 随时 可 能 被 垃圾 回收 器 给 回收 。 


可 以 执行 的 操作 


根据 上 面 的 描述 ， 对 弱 集 合 对 象 可 以 进行 的 操作 仅 限于 。 


e 增加 成 员 ， 使 用 add() 方法 增加 成 员 
e 删除 成 员 , 使 用 delete() 方法 删除 成 员 


e 判断 成 员 是 否 在 集合 ， 使 用 has() 方法 判断 一 个 成 员 是 否 存在 


弱 集 合 的 使 用 


弱 集 合 的 一 个 使 用 场合 是 你 需要 操作 DOM 的 一 个 集合 ， 但 是 你 不 想 因为 集合 拥有 对 
DOM 对 象 的 引用 而 阻止 对 DOM 对 象 的 自动 销毁 。 


映射 


我 们 可 以 把 映射 看 成 是 对 JavaScript Object 的 一 个 扩展 。 在 传统 的 JavaScript 
Object 中 ， 当 我 们 设置 key, value 对 的 时 候 ，key 只 能 是 字符 串 。ES6 对 这 个 进行 了 
扩展 ， 形 成 了 新 的 映射 类 型 ， 了 映射 类 型 的 key, value 对 可 以 是 任意 对 象 。 


映射 的 初始 化 


在 ES6 中 ， 可 以 通过 如 下 2 种 对 构造 函数 的 调用 来 创建 并 初始 化 一 个 映射 对 象 
o 不 传 参 数 给 构造 函数 ， 这 将 创建 一 个 空 的 映射 


var sampleMap = new Map(); 
console.log(sampleMap.size); //will output 0 


e 传 一 个 数组 给 构造 函数 ， 这 个 传 入 的 数组 的 每 个 元 素 包 含 2 个 值 ， 第 一 个 将 作 
为 key, 另外 一 个 作为 value 


var sampleMap = new Map([['key1', 'val1'], ['key2', 'val2']]); 
//will output 2, also sampleMap will have key key1 and key2 
console.log(sampleMap.size);//will output 2 
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增加 成 员 ， 通 过 set(key, val) 向 映射 对 象 增加 成 员 

删除 成 员 ， 通 过 delete(key) 从 映射 对 象 删除 成 员 

测试 是 否 包 含 ， 通 过 has(key) 测试 是 否 包含 某 个 key 

获取 成 员 ， 通 过 get(key) 返回 成 员 

清空 成 员 ， 通 过 clear() 操作 清空 整个 映射 对 象 

另外 ， 了 映射 对 象 和 集合 对 象 一 样 ， 当 你 使 用 object 作 为 key 的 时 候 ， 是 根据 key 是否 


指向 同样 的 内 存 对 象 来 判断 是 否 new 一 个 key 的 。 如 果 2 个 key 的 对 象 指 向 的 是 同一 
个 内 存 对 象 ， 那 么 后 面 一 个 set 将 履 盖 前 面 一 个 set 的 内 容 。 


对 映射 对 象 的 遍历 


对 映射 对 象 ， 你 可 以 使 用 下 面 的 任意 一 种 方法 进行 合适 的 遍历 。 


^^javascript 

'use strict'; 
var sampleMap - new Map(); 
sampleMap.set('key1', 'val1'); 
sampleMap.set('key2', 'val2'); 
for (let key of sampleMap.keys()){ 
console.log(key + '---' + sampleMap.get(key)); 
} 


``javascript 

'use strict'; 
var sampleMap = new Map(); 
sampleMap.set('key1', 'val1'); 
sampleMap.set('key2', 'val2'); 
for (let val of sampleMap.values()){ 
console.log(val); 


"javascript 

'use strict'; 
var sampleMap = new Map(); 
sampleMap.set('key1', 'val1'); 
sampleMap.set('key2', 'val2'); 
for (let item of sampleMap.entries()){ 
console.log(item[0] + '---' + item[1]) 


, 


* forEach() 调用 


'use strict'; 

var sampleMap - new Map(); 
sampleMap.set('key1', 'val1'); 
sampleMap.set('key2', 'val2'); 
sampleMap.forEach(function(value, key, map){ 
console.log(key + '---' + value); 


3); 


弱 映 射 


和 弱 集 合 一 样 ， 弦 映射 的 key 不 被 垃圾 回收 所 检查 ， 当 key 对 应 的 对 象 被 回收 的 时 
候 ， 也 自动 从 弱 映 射 中 被 删除 。 由 于 这 个 原因 ， 弱 映射 和 弱 集 合 一 样 无 法 进行 遍 
历 ， 这 能 修改 。 


arrow functions 


箭 向 函数 


Let 4 


z 3 Lett = 


在 ES6 中 引入 了 let 命 令 ， 通 过 let 命 令 定义 的 变量 只 能 在 let 命 令 所 在 的 代码 块 内 部 被 
引用 。 


"use strict" 
let hello = "Hello World!" 

console.log(hello) // 会 报错 ， 因 为 没有 全 局 的 helL1o 变 量 被 定义 
从 上 面 的 例子 可 以 看 出 ， 使 用 Let 命 令 定 义 的 变量 不 会 自动 被 提升 为 全 局 变量 。 相 反 
的 情况 ， 如 果 在 上 面 的 例子 中 ， 你 使 用 var 来 定义 hello 这 个 变量 ， 那 么 hello 这 个 变 
量 将 自动 被 提升 为 全 局 变量 ， 就 可 以 被 后 面 的 console.log 访 问 了 。 

ee 
ew eR 
ES6 中 规定 ， 如 果 你 在 一 个 代码 区 块 中 使 用 了 let 命 令 来 定义 变量 ， 那 么 在 变量 被 定 


义 之 前 ， 不 允许 对 这 个 变量 的 访问 存在 。 因 此 在 let 命 令 之 前 的 所 有 代码 被 称 为 变量 
死 区 。 如 果 在 变量 死 区 发 生 了 对 变量 的 引用 ， 那 么 JavaScript 引 擎 将 报错 。 


"use strict" 


1 
console.log(hello); // 将 报错 ， 因 为 变量 声明 在 之 后 
let hello = "Hello World!"; 
} 
# 正 确 代码 
let hello = "Hello World!"; 
console.log(hello); 
} 


不 能 重复 声明 变量 


在 同一 个 代码 区 块 中 ， 你 不 能 使 用 let/var 命 令 重 复 定义 一 个 已 经 已 经 存在 的 变量 。 
因此 下 面 的 代码 将 报错 。 


"use strict" 


{ 
let hello = "Hello World!"; 
let hello = "Hello Not World!";//4k4 
console.log(hello); 

J 

1 
let hello = "Hello World!"; 
var hello = "Hello Not World!";//iR43 
console.log(hello); 

} 

块 级 作用 域 


ES6 引 入 let 命 令 的 一 个 副作用 就 是 引入 了 块 级 作用 域 。 让 我 们 来 看 一 个 具体 的 例子 
来 详细 2 as 


function f() { console.log('I am outside!'); } 
(runetton co pt 
if(false) { 
// 重复 声明 一 次 函数 ff 
function f() ( console.log('I am inside!'); } 


j 


f(); 
10); 


在 ES5 环 境 中 ， 这 段 代码 将 输出 "| am insidel"， 这 个 是 因为 在 ES5 中 ， 不 管 代 码 块 
是 否 被 运行 ， 函 数 定 义 都 将 自动 被 提升 到 外 部 (全 局 空间 ) 。 但 是 如 果 在 ES6 中 运 
行 ， 你 将 看 到 输出 "| am outsidel"， 这 个 是 因为 重复 的 function 定 义 是 在 另外 一 个 不 
被 执行 的 代码 块 中 。 实 际 上 在 ES6 中 ， 上 面 的 代码 被 翻译 成 了 下 面 的 ES5 代 码 。 


"use strict"; 


function sayHello() { 
console.log("say hello from global"); 
j 


(function () { 

if (false) { 
var _sayHello = function _sayHello() { 
console.log("say hello from inside"); 


H 
} 


sayHello(); 
JO; 


块 级 作用 域 的 另外 一 个 影响 就 是 把 变量 绑 定 到 了 当前 的 作用 域 


“use strict”. 
function hello() ( 
let word - "hello world!"; 
if (false) ( 
let word = "hello world1!"; 


console.log(word); 


j 


hello();//will see "Hello world!" 


const 4 


const 命 令 和 |et 命 令 唯 一 的 区 别 在 于 constant 命 令 定义 的 是 一 个 常量 。 因 此 使 用 
constant 命 令 定义 的 常量 必须 在 定义 的 同时 被 初始 化 。 


引入 其 他 js 文件 中 定义 的 变量 /第 量 


在 ES6 中 ， 可 以 使 用 import 语 句 来 引入 其 他 文件 中 定义 的 常量 / 变量 。 


"use strict" 
// 定 义 在 constants.js 的 常量 
export const HELLO = "hello" 


// 在 其 他 js 中 
import * as constants from "./constants.js" 
console.log(constants.HELLO) 


import {HELLO as myHello} from "./constants.js" 
console. log(myHello) 


全 局 变量 的 属性 


在 ES6 中 ， 使 用 var 定 义 的 变量 将 是 全 局 变量 的 属性 (window --- 在 browser 中 or 
global-- 在 server 段 代码 中 )， 因 此 可 以 通过 Window. 或 者 global. 来 访问 。 但 是 在 顶层 
代码 中 使 用 let / constant 定 义 的 变量 /常量 将 不 是 全 局 变量 的 属性 。 


概述 


在 ES63 引 入 模板 字符 串 之 前 ， 如 果 大 家 需要 在 代码 中 创建 一 个 包含 变量 的 字符 囊 ， 
那么 代码 将 非常 难 读 ， 并 且 也 非常 容易 出 错 。 下 面 就 是 一 个 简单 的 例子 ， 在 例子 中 
我 们 将 输入 的 3 个 参数 拼接 在 一 起 ， 然 后 返回 给 调用 方 。 


// 在 模板 字符 囊 出 现 前 的 写法 ， 写 法 兄长 而 且 难 于 理解 
function returnSomthing(param1, param2, param3){ 
return "something return based on input(" 
+ "parami:" + parami.toString() + "---" 
+ "param2:" + param2.toString() + "---" 
+ "param3:" + param3.toString(); 


} 


// 使 用 模板 字符 串 的 写法 ， 
function returnSomthingNew(param1, param2, param3){ 
return "something return based on input( 
param1:${param1}---param2:${param2}- --param3:$1(param: 





通过 上 面 的 代码 ， 你 可 以 看 出 在 使 用 模板 字符 串 之 后 ， 代 码 变 入 
容 匈 阅读 。 下 面 是 在 使 用 模板 字符 囊 时 候 的 一 些 注意 点 


e 模板 字符 串 是 使 用 ”引用 起 来 的 ， 如 果 在 最 终生 成 的 字符 串 中 包含 "字符 ， 那 么 
需要 使 用 \ 字 符 进行 转 义 

e 模板 字符 串 中 对 于 变量 的 引用 是 通过 $f} 来 进行 的 

o 使 用 模板 字符 串 的 时 候 ，9$ 们 中 可 以 放 入 任意 合法 的 JavaScript 表 达 式 。 
JavaScript 对 包含 在 $f} 中 的 内 容 实际 上 是 通过 eval 表 达 式 来 进行 的 


标签 模板 


模板 字符 囊 可 以 跟 在 一 个 函数 名 之 后 ， 该 函数 将 被 调用 来 处 理 跟 在 后 面 的 模板 字符 
串 ， 这 个 功能 被 称 为 标签 模板 。 被 调用 的 函数 将 接收 到 下 面 的 参数 列表 
(literals,...values)。 其 中 literals 是 一 个 数组 ， 内 容 是 模板 字符 串 中 不 需要 进行 变量 
替换 的 部 分 ， 而 values 就 是 每 个 替换 变量 经 过 eval 之 后 的 值 ， 下 面 是 一 个 具体 的 例 
FT 


一 起 学 koa 


var total = 30; 
var msg = transform The total number is ${total} ; 
total - 20; 
var msgi = transform The total number is ${total}'; 
//in our sample 
//literals - ["The total number is ", ""] 
//values - [30] 
function transform(literals, ...values){ 
var output = ""; 
for (var index = 0; index < values.length; index++){ 
if (parseInt(values[index]) >= 30){ 
output += literals[index] + "high value"; 
}else{ 
output += literals[index] + "low value"; 
} 
} 


output += literals[index]; 
return output; 


} 
console.log(msg); //output The total number is high value 
console.log(msg1);//output The total number is low value 


template strings 


Promise 55 4 & 


在 Promise 出 现 之 前 ， 如 果 大 家 需要 实现 异步 操作 ， 通 用 的 做 法 是 事件 加 上 回调 函 
数 ， 如 果 我 们 有 多 个 异步 操作 需要 瞬 套 执行 的 话 ， 那 么 代码 将 变 得 非常 难于 阅读 。 
让 我 们 来 看 一 个 具体 的 代码 例子 。 在 下 面 的 例子 中 ， 我 们 首先 通过 Http request] 

用 一 个 web service， 然 后 将 从 web service 收 到 的 数据 写 入 一 个 本 地 文件 。 从 任务 

的 角度 来 看 ， 这 是 一 个 非常 简单 的 任务 ， 但 是 当 你 第 一 次 看 到 这 个 代码 的 时 候 ， 一 
定 觉 得 头 很 学， 因为 在 这 段 代码 中 


e 对 Web service 进 行 调用 的 代码 和 号 文件 的 代码 混杂 在 一 起 (E STERILIS A E 
在 end 事件 的 回调 函数 中 ) ， 造 成 代码 模块 不 清晰 ， 阅 读 和 理解 起 来 比较 费 
劲 。 

e 对 错误 的 处 理 分 散在 代码 的 各 个 地 方 ， 而 且 错 误 处 理 的 实现 方式 都 不 一 样 。 对 
Web service 进 行 调 用 的 代码 ， e error 事件 来 处 理 错误 ， p e 
E 出 到 je | s 而 写 文件 的 代码 是 通 过 回调 E BO AE 44 误 ， 并 将 错 i 误 通 
过 throw BJ > 


var http - require("http"); 

Var iS = Requires) 

var querystring - require("querystring"); 

var postData = querystring.stringify({ 
'msg' : 'Hello World!' 

+); 


var options = ( 
hostname: '127.0.0.1', 
port: 8080, 
path: '/upload', 
method: 'POST', 
headers: { 
'Content-Type': 'application/x-www-form-urlencoded', 
'Content-Length': postData.length 
} 
y; 


var req = http.request(options, (res) => { 
console.log( STATUS: ${res.statusCode} ); 
console.log( HEADERS: ${JSON.stringify(res.headers)} ); 
res.setEncoding( 'utf8'); 


var dataReceived = "" 


res.on('data', (chunk) => { 

dataReceived = dataReceived + chunk.toString(); 
console.log( BODY: ${chunk}~); 
3); 


res.on('end', () => { 
console.log('No more data in response.') 
//now we try to write the message to a file 
fs.writeFile("temp.txt", dataReceived, function(err){ 
if (err)( 
throw err; 


console.log("Write file temp.txt succ"); 
3); 
}) 
+); 


req.on('error', (e) => { 
console.log( problem with request: ${e.message} ); 


+); 


// write data to request body 
req.write(postData); 
req.end(); 


接 下 来 ， 让 我 们 使 用 Promise 重 写 上 面 的 代码 。 在 重 写 的 代码 中 ， 我 们 可 以 看 到 : 
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e 对 Web service 进 行 调用 的 代码 和 写 文 件 的 代码 完全 分 离开 了 ， 代 码 结构 变 得 非 
常 清晰 。 在 阅读 代码 的 过 程 中 ， 不 会 再 被 不 相关 的 代码 所 干扰 。 

e Promise 对 象 对 外 提供 了 统一 的 回调 函数 接口 〈resolve 和 reject 回 调 函 数 ) > 
在 重 写 的 代码 中 ， 我 们 可 以 很 容易 的 把 对 web service 的 请 求 分 装 到 一 个 模块 
中 ， 从 而 对 外 隐藏 Http Request 的 所 有 细节 。 

e 通过 Promise 对 象 的 封装 ， 对 错误 代码 的 处 理 被 统一 了 ， 都 是 通过 
对 reject 函数 调用 来 说 明 异 步 操 作 过 程 中 有 错误 发 生 ， 而 且 错 误 被 集中 
到 catch 代码 段 进 行 了 处 理 (错误 都 被 输出 到 了 控制 台 ) 。 

e 通过 Promise 的 封装 ， 措 步 操 作 的 代码 变 得 和 同步 操作 代码 很 像 ， 更 方便 其 他 
人 理解 代码 的 处 理 逻 辑 。 


'use strict'; 

var http - require("http"); 

var fs - require("fs"); 

var querystring - require("querystring"); 

var postData = querystring.stringify({ 
'msg' : 'Hello World!' 

+); 


var options = ( 
hostname: '127.0.0.1', 
port: 8080, 
path: '/upload', 
method: 'POST', 
headers: ( 
'Content-Type': 'application/x-www-form-urlencoded', 
'Content-Length': postData.length 
} 
}; 


var pHttpRequest = new Promise(function(resolve, reject)t 
let req = http.request(options, (res) => { 
console.log( STATUS: ${res.statusCode} `); 
console.log( HEADERS: ${JSON.stringify(res.headers)} ); 
res.setEncoding( 'utf8'); 


let dataReceived = "" 


res.on('data', (chunk) => { 
dataReceived = dataReceived + chunk.toString(); 


+); 


res.on('end', () => £ 
resolve(dataReceived); 
+) 
3): 


req.on('error', function(e){ 
reject(e); 


+); 


req.write(postData); 
req.end(); 
}) 


pHttpRequest.then( 

//http request promise; Z/ H 4& 4 

//&http request promise 成 功 的 时 人 

function(dataReceived)( 

return new Promise(function(resolve, reject)( 
fs.writeFile("temp.txt", dataReceived, function(e){ 

if (e) reject(e); 
else resolve("Write file succ"); 


+); 


处 理 
疼 ， 开 始 处 理 写 文件 操作 


}) 


} 
).then( 
//writeFile promise 成 功 时 候 的 处 理 
function(msg) { 
console.log(msg); 


} 
).catch( 
// 全 局 错误 处 理 
function(err)( 
console.log("some error happen(" + err + ")"); 


} 
) 
iE AX KF Promise na ae & > ES6sE A Promise xt 2:28 4€ T AR 
的 一 个 内 置 对 象 ， 大 家 再 也 不 用 通过 第 三 方 库 开 始 用 Promise 对 象 了 。 
Promise 对 象 的 特性 


e Promise 对 象 一 旦 创建 ， 就 开始 执行 了 ， 你 没有 办 法 取消 Promise 对 象 的 执行 。 

e Promise 对 象 的 状态 只 由 异步 操作 的 结果 决定 ， 没 有 任何 其 他 的 操作 可 以 改变 
Promise 对 象 的 状态 如 果 异 步 操 作 执 行 成 功 ，Promise 对 象 将 进入 Resolved 状 
态 ， 同 时 resolve 函 数 将 被 调用 ; 如 果 异 步 操 作 执 行 失败 ，Promise 对 象 将 进入 
Rejected 状 态 ， 同 时 reject 有 函数 将 被 调用 。 

e Promise 对 象 一 旦 进入 Resolved 或 者 Rejected 状 态 ， 状 态 将 不 可 能 再 发 生变 
化 ， 在 Promise 对 象 被 销毁 之 前 ， 将 一 直 保 持 Resolved 或 者 Rejected 状 态 。 

e 因为 Promise 对 象 的 实现 方法 ， Hain c 出 现 的 异常 是 不 会 被 抛 出 
的 ， 因 此 需要 在 Promise 对 象 内 部 进行 处 理 (通过 提供 ,catch 代码 段 来 实 
IL) > 


下 图 表示 了 一 个 Promise 对 象 的 整个 生命 周期 。 


Pending ( 当 Promise 对 象 被 创建 ) 
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Promise 对 象 的 使 用 











创建 Promise 对 象 


在 ES6 中 ， 你 可 以 通过 new Promise(function(resolve, reject){ }) 来 创建 
Promise 对 象 ， 下 面 是 一 个 具体 的 代码 。 


'use strict'; 
var fs - require("fs"); 
var promiseObj = new Promise(function(resolve, reject){ 
//put some code to call 
fs.readFile("temp.txt", (err, data) => { 
if (err)( 
reject(err); 
}else{ 
resolved(data); 


关联 resolve function reject function 


在 上 面 的 例子 中 ， 如 果 你 执行 这 个 代码 ， 你 会 发 现 没 有 任何 的 效果 (没有 输出 ) > 
那 是 因为 你 没有 给 这 个 创建 的 Promise 对 象 关 联 相应 的 resolye 和 reject 函 数 。 下 面 是 
一 个 进一步 的 例子 ， 这 个 例子 将 给 Promise 对 象 绑 定 resolve 和 reject 部 数 ， 你 就 可 以 
看 到 效果 了 。 在 我 的 测试 环境 中 ， 因 为 我 们 有 名 为 "temp.txt" 的 文件 存在 ， 所 以 输出 
了 file read fail 。 


'use strict'; 
var fs - require("fs"); 
var promiseObj = new Promise(function(resolve, reject){ 
//put some code to call 
fs.readFile("temp.txt", (err, data) => { 
if (err)( 
reject(err); 
}else{ 
resolved(data); 
} 


}); 
}); 
promiseObj.then(function(data)( 
console.log("file read succ"); 
}, function(err){ 
console.log("file read fail"); 


}) 


在 通常 情况 下 ，reject 状 态 的 函数 我 们 一 般 不 在 then 中 设置 ， 而 是 在 catch 中 设置 ， 
这 样 代 码 看 起 来 更 像 是 传统 意义 上 的 同步 代码 (和 try...catch 比 较 ) 。 因 此 上 面 的 例 
子 可 以 重新 写成 


'use strict'; 
var fs - require("fs"); 
var promiseObj = new Promise(function(resolve, reject){ 
//put some code to call 
fs.readFile("temp.txt", (err, data) => { 
if (err){ 
reject(err); 
}else{ 
resolved(data); 
} 


}); 
}); 
promiseObj.then(function(data)( 
console.log("file read succ"); 
}).catch(function(err){ 
console.log("file read fail"); 


3): 


级 联 多 个 Promise 对 象 


Promise 对 象 的 resolve 函 数 的 参数 可 以 是 另外 一 个 Promise 对 象 ， 这 样 就 可 以 将 2 个 
Promise 对 象 级 联 起 来 。 下 面 是 一 个 简单 的 例子 


'use strict'; 
var p1 = new Promise(function(resolve, reject){ 
setTimeout(() => reject(new Error("something test"), 3000)); 


+); 


var p2 = new Promise(function(resolve, reject){ 
setTimeout(() => resolve(p1), 1000); 
3); 


p2.then(function(data){ 
console.log("p2 succ"); 
}).catch(function(err){ 
console.log("p2 fail"); 
3); 


Promise 55 HA 


Promise.all() 


$ 3 ^ Promise & X 5 — 4- 4-31 59 Promise Object > 如 果 所 有 的 Promise 被 
Resolved， 那 么 新 的 Promise 将 被 Resolve ; 否则 新 的 Promise 将 被 Reject 。 


Promise.race() 


id all—## > .racet$de $ “Promise & € Xx— 4- 31 49 Promise Object， 不 同 的 地 方 
是 。 这 些 Promise 之 中 任何 一 个 Resolve 或 者 Reject 了 ， 新 的 Promise 就 被 Resolve 或 
者 Reject 了 。 


Promise.resolve() 
将 传 入 的 对 象 封 装 成 一 个 Promise 对 象 返 回 。resolve 方 法 根据 以 下 的 规则 返回 
Promise 对 象 。 
e 如 果 输 入 的 参数 本 身 是 一 个 Promise 对 象 ， 那 么 resolve 方 法 直接 返回 这 个 对 
e 如 果 输 入 的 对 象 本 身 有 then 方 法 (必须 是 一 个 可 以 接受 2 个 function 的 方法 ) > 


那么 resolve 将 这 个 对 象 转换 成 Promise 对 象 ， 并 理解 调用 then 方 法 ; 下 面 是 一 
个 例子 


//for this example, you will see following output 
Th then function in thenobject 
// Promise object resolve function is called Then function is ca: 
var thenobject = ( 
then: function(resolve, reject){ 
console.log("then function in thenobject"); 
resolve("Then function is called"); 


+; 


var pObj = Promise.resolve(thenobject); 
pObj . then(function(data) { 
console.log("Promise object resolve function is called " + dat: 


}); 
加 于 = 于 
e 如 果 传 入 的 参数 就 是 一 个 普通 对 象 ， 那 么 返回 的 Promise 对 象 直 接 处 于 


resolved 状 态 ， 并 且 输 入 的 参数 将 作为 resolved 状 态 下 调用 的 函数 的 参数 。 下 
面 是 一 个 具体 的 例子 。 





//for this example, you will see following output 
// Promise object resolve function is called Hello World! 
var pObj = Promise.resolve("Hello World!"); 
pObj . then(function(data) { 
console.log("Promise object resolve function is called " + dat: 


+); 
El AA SS z 





* 如 果 没 有 输入 参数 ， 那 么 返回 的 Promise 对 象 直接 处 于 resolved 状 态 ， 并 且 
resolved 状 态 下 调用 的 函数 没有 输入 参数 。 


done() method 


通过 在 Promise 的 调用 链 最 后 使 用 这 个 方法 ， 可 以 保证 catch 到 任何 的 错误 。 


finally() method 


如 果 你 需要 在 Promise 结 束 的 时 候 (不 管 resolve 还 是 reject 结 束 ) ， 都 有 一 个 函数 被 
调用 ， 那 么 就 需要 使 用 这 个 方法 。 这 个 方法 接受 一 个 回调 函数 作为 输入 。 当 
Promise 结 束 的 时 候 ， 这 个 回调 函数 将 被 调用 。 


概述 


在 ES5 中 ， 所 有 的 属性 名 使 用 的 都 是 标准 的 字符 串 ， 如 果 你 想 修改 一 个 别人 提供 的 
对 象 ， 并 且 为 这 个 对 象 增加 一 个 方法 的 时 候 ， 你 就 要 非常 小 心 了 ， 因 为 你 可 能 选择 
了 一 个 已 经 存在 的 方法 的 名 字 。 因此 在 ES6 中 引入 了 Symbol 这 个 类 型 ， 当 你 使 用 
Symbol 类 型 来 定义 类 的 属性 或 者 方法 名 的 时 候 ，ES6 将 保证 这 个 属性 和 方法 名 称 是 
全 局 唯一 的 。 


创建 Symbol 实例 


# 第 一 种 方法 直接 使 用 Symbol 构造 函数 

var si = Symbol(); 

# 为 创建 的 Symbol 对 象 指定 一 个 名 称 

var s2 = Symbol("test"); 

H 使 用 这 种 方法 ， 每 次 创建 出 来 的 Symbol1 对 象 都 是 不 一 样 的 
var s3 = Symbol("test"); 

# console.log(s2 == s3)#& false 


# 第 二 种 方法 ， 使 用 Symbol1.for 方 法 来 创建 Symbol 实例 

4 使 用 Symbol.for 方 法 来 创建 一 个 Symbol 实例 的 时 候 ， 

H 系统 首先 会 在 一 个 全 局 的 注册 表 中 查找 是 否 有 相同 Key 名 称 的 Symbol 被 创建 了 ， 如 果 找 : 
# 否则 ， 将 创建 一 个 全 新 的 对 象 

s1 = Symbol.for("test") 

s2 = Symbol.for("test") 

console.log(si == s2) //will return true 

console.log(si == s3) // will return false， 因 为 S3 是 通过 Symbol1 调 用 产生 


Fur 





在 我 们 了 解 了 ES6 为 什么 需要 引入 Symbol 对 象 之 后 ， 让 我 们 来 看 一 些 具体 的 例子 来 
增加 一 些 对 Symbol 对 象 的 感性 的 认识 。 


引用 实例 1 --- 对 象 的 属性 
使 用 Symbol 来 定义 类 的 属性 


var a = {}; 
var s1 = Symbol("test"); 
a[s1] = "hello world!"; 


console.log(a[s1]); //this will print "Hello World!" 
需要 注意 的 是 ， 当 使 用 Symbol 作为 属性 名 的 时 候 ， 一 定 要 用 [] 来 进行 引用 ， 如 果 你 
A. (点 号 ) 进行 引用 ， 那 么 产生 的 属性 名 实际 是 一 个 字符 串 ， 和 Symbol 对 象 本 身 
没 一 点 关系 


遍历 使 用 Symbol 来 定义 的 属性 


为 Symbol 对 象 不 是 一 个 字符 串 ， 所 以 原先 的 Object.getOwnPropertyNames() 
方法 并 不 会 返回 它们 ， 你 需要 使 用 专门 的 Object.getOwnPropertySymbols() 方 法 
来 访问 它们 。 


var a = (Y 

var s1 = Symbol("test"); 

var s2 Symbol("testfunc"); 

a[s1] = "hello world!"; 

a[s2] = function()( 
console.log("Test function"); 


3 

//below code will return [] 
console.log(Object.getOwnPropertyNames(a) ); 

//below code will return [Symbol(test), Symbol(testfunc) ] 
console.log(Object.getOwnPropertySymbols(a)); 


引用 实例 2 --- 消除 魔术 字符 串 


魔术 字符 串 指 的 是 在 代码 中 反复 出 现 的 相同 的 字符 串 ， 对 一 个 结构 良好 的 代码 来 
说 ， 应 该 尽量 消除 魔术 字符 串 的 存在 ， 而 使 用 常量 作为 蔡 代 。 下 面 就 让 我 们 来 看 一 
个 具体 的 例子 来 了 解 如 何 使 用 Symbol 来 消除 代码 中 的 魔术 字符 串 。 在 代码 中 我 们 
尝试 根据 输入 信息 的 不 同 返回 不 同 的 Hello 


# 引入 Symbol 前 的 代码 

# 在 这 个 代码 中 es， ch 就 是 魔术 字符 串 

H 当 你 在 调用 这 个 函数 的 时 候 ， 必 须 确保 输入 的 参数 是 一 个 有 效 的 魔术 值 
function getHello(country){ 


switch(country){ 
case "es": 
return "Holla"; 
case "ch": 
return "你 好 "， 
default: 


return "Hello"; 


} 


console.log(getHello("es")); 
console.log(getHello("ch")); 


4 引入 Symbol 之 后 的 代码 
# 在 这 个 代码 中 es， ch 不 再 是 一 个 具体 的 字符 串 
4 因此 不 管 在 COUNTRY_CODE 中 如 何 修改 es， ch 的 定义 ， 调 用 方 的 代码 都 不 需要 修改 
const COUNTRY CODE- { 
es: Symbol(), 
ch: Symbol() 


} 
function getHello(country){ 


switch(country){ 
case COUNTRY CODE.es: 
return "Holla"; 
case COUNTRY CODE.ch: 
return "435" 
default: 
return "Hello" 


j 


j 
console.log(getHello(COUNTRY CODE.es)); 
console.log(getHello(COUNTRY CODE.ch)); 


ES6 内 置 的 Symbol 实例 


Symbol.haslnstance 

对 对 象 使 用 instanceof 调 用 的 时 候 ， 在 ES6 内 部 调用 的 是 obj[Symbol.haslnstance] 方 
法 

Symbol.isConcatSpreadable 


决定 调用 Array.prototype.contact 方 法 的 时 候 ， 对 象 是 否 可 以 展开 


var arra = [1,2]; 
[3, 4].concat(arr1); 77 return [3, 4, 1, 2 


arri[Symbol. le false; 
[3, 4].concat(arr1); // retu [occa e 2] 


和 字符 串 操 作 相 关 的 Symbol 


Symbol.replace 指 向 一 个 方法 ， 将 被 String.prototype.replace 调 用 
Symbol.search 指 向 一 个 方法 ， 将 被 String.prototype.search 调 用 
Symbol.split 指 向 一 个 方法 ， 将 被 String.prototype.split 调 用 
Symbol.match 指 向 一 个 方法 ， 将 被 strmatch(object) 调 用 
Symbol.toStringTag 只 想 一 个 方法 ， 将 被 Object.prototype.toString 调 用 


Symbol.iterator 


指向 对 象 的 默认 遍历 器 


Symbol.toPrimitive 


指向 一 个 方法 ， 将 对 象 转换 成 一 个 primitive 类 型 的 值 。 这 个 方法 将 接受 一 个 hint 
参数 ， 表 示 要 转换 成 哪 种 primitive 类 型 ， 具 体 的 value 包 括 "Number", "String", 
"Default" 


Symbol.unscopables 


指向 一 个 属性 ， 这 个 属性 返回 一 个 JSON 对 象 ， 表 示 该 对 象 的 哪些 属性 将 被 
with 环境 排除 在 外 ， 下 面 是 一 个 具体 的 例子 。 


# when Test has no Symbol.unscopables 
class Test( 
saySomething() { return "abc"; } 


var saySomething = function() { return "123"; } 
with(Test.prototype) { 
saySomething(); // return "abc" 
} 
# when Test has Symbole.unscopables 
class Test{ 
saySomething() { return "abc"; } 
get [Symbol.unscopables] { 
return {saySomething: true}; 
} 


with(Test.prototype){ 
saySomething(); // now return "123" 


j 


> http://koajs.com/ 
: http://koa.bootcss.com/ 
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app.use(function *(next){ 
this; // is the Context 
this.request; // is a koa Request 
this.response; // is a koa Response 


+); 


说 明 : 


。this 是 上 下 文 (注释 1*) 
e "X &es6 € to generator 


http 模 型 里 的 请 求 和 响应 


e this.request 
e this.response 


对 比 express 的 中 间 件 


app.use(function (req, res, next) ( 
return next(); 


3); 


express 里 的 req 和 res 是 显 式 声明 ， 看 起 来 更 清晰 一 些 
next 处 理 是 一 样 的 ， 二 者 无 差异 


注释 1 : 此 处 的 this 并 不 同 于 通常 状态 下 的 this 指向 〈《 即 调用 者 ) 。 在 koa 中 this 指 
向 每 一 次 的 请 求 ， 在 请 求 接受 后 初始 化 ， 在 一 次 请 求 结 束 后 被 释放 。 


koa-generator 


这 里 的 generator 是 生成 器 的 意思 ， 用 于 生成 项 目 骨架 ，express-generator 就 是 一 个 
比较 好 的 例子 ， 虽 然 比较 精简 ， 但 结构 清晰 ， 足 矣 满足 一 般 性 的 开发 需求 


鉴于 很 多 人 非常 熟悉 expressjs， 这 里 假定 大 家 也 熟悉 express-generator 
express-generator 提 供 的 功能 

e 生成 项 目 骨 架 

e 约定 目录 结构 (经 典 ， 精 简 ， 结 构 清晰 ) 

e 支持 css 预 处 理 器 
koa-generator 提 供 的 功能 


e 生成 项 目 骨 架 
e 约定 目录 结构 (和 express-generator 的 结构 一 模 一 样 ) 
e 支持 css 预 处 理 器 ( 暂 未 实行 ) 


2 个 生成 器 共同 的 项 目 骨架 结构 


app.js 为 入 口 

bin/www 7 È A Y 

支持 static server > FP public A x 
支持 routes 路 由 目录 

支持 views 视 图 目录 

默认 jade 为 模板 引擎 


koa-generator 支 持 koa1.x 和 2.x， 安 装 后 ， 可 以 分 别 使 用 koa fe koa2 分 别 创 建 。 


4C X koa-generator 


$ npm install -g koa-generator 


创建 项 目 


koa-generator 支 持 Koa1.x 和 2.x， 安 装 后 ， 可 以 分 别 使 用 koa 和 koa2 分 别 创 
建 。 


Koa 1.x 


$ koa helloworld 


Koa 2.x 


$ koa2 helloworld 


切换 视图 模板 引 学 

视图 默认 使 用 的 是 jade 。 如 果 想 使 用 其 他 的 视图 
$ koa 1.x/views-ejs -e 

说 明 


e -e, --ejs add ejs engine support (defaults to jade) 


koa-generatori& Al #9 X: koa-views > & 4& M4 consolidate.js X 44 1% 4x 5] E 


路 由 


写法 说 明 


Koa 1.x 
只 要 是 koa-router 写 的 路 由 都 可 以 加 载 的 ， 加 载 方式 和 express 里 一 样 


var router = require('koa-router')(); 


router.get('/', function *(next) { 
this.body - 'this /1!'; 
+); 


router.get('2', function *(next) { 
this. body = "this 7217 
3); 


module.exports - router; 


一 定 要 区 分 


url = /2 

router.get('2', function *(next) { 
this.body - 'this /2!'; 

3); 


url = //2 

router.get('/2', function *(next) { 
this.body = 'this /2!'; 

+); 


这 个 是 koa-router 的 一 个 问题 ， 和 express 里 的 路 由 稍 有 不 一 样 ， 注 意 一 些 即 可 


Koa 2.x 


由 于 Koa 2.x 支 持 async， 故 写法 稍 有 差异 


一 起 学 koa 


var router = require('koa-router')(); 


router.get('/', async function (ctx, 
await ctx.render('index', { 
title: 'Hello World Koa!' 
3); 
3); 


module.exports - router; 


Routes 


next) { 
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HTTP 


Get 


npm run 1 


如 何 获取 query 参 数 
routes/index.js 


var router = require('koa-router')(); 


router.get('/', function *(next) { 
console.log(this.request.query) 
console.log(this.query) 


yield this.render('index', ( 
title: 'Hello World Koa!' 
3); 
3); 


module.exports - router; 


3$ l4] http://127 .0.0.1:3000/?a71 
日 志 
<-- GET /?a=1 
a at 
[ a: '1') 
和 express 里 获取 query 的 方法 是 一 样 的 ，req.query 
koa 里 是 


e this.request.query 
e this.query 


这 里 需要 说 明 以 下 this 上 下 文 上 有 request 和 response2 个 对 象 ， 每 次 写 起 来 又 比较 
麻烦 


于 是 把 request 和 response 上 的 方法 也 丢 给 this， 这 样 就 相当 于 this 上 有 了 对 应 
request 和 response 里 的 方法 的 别名 (META) 


e 别名 列表 
Request aliases 
以 下 访问 器 和 别名 与 Request 等 价 : 


e ctx.header 
e ctx.method 
e ctx.method= 


ctx.url 

ctx.url= 

ctx.originalUrl 
ctx.path 

ctx.path= 

ctx.query 

ctx.query= 
ctx.querystring 
ctx.querystring= 
ctx.host 
ctx.hostname 
ctx.fresh 

ctx.stale 

ctx.socket 
ctx.protocol 
ctx.secure 

ctx.ip 

ctx.ips 
ctx.subdomains 
ctx.is() 

ctx.accepts() 
ctx.acceptsEncodings() 
ctx.acceptsCharsets() 
ctx.acceptsLanguages() 
ctx.get() 


Response aliases 
以 下 访问 器 和 别名 与 Response 等 价 : 


ctx.body 
ctx.body= 
ctx.status 
ctx.status- 
ctx.length= 
ctx.length 
ctx.type= 
ctx.type 
ctx.headerSent 
ctx.redirect() 
ctx.attachment() 
ctx.set() 
ctx.remove() 
ctx.lastModified= 
ctx.etag= 


如 何 获取 params 


eXxpress 里 经 典 用 法 
http://expressjs.com/en/4x/api.html#app.param 
app.get('/user/:id', function (req, res, next) { 
console.log('although this matches'); 


next(); 


3); 


请 求 是 
访问 http:/127.0.0.1:3000/users/alfred 
那么 koa 里 如 何 使 用 呢 ? 
关于 路 由 
e express 是 自 带路 由 
e koa 这 货 没有 ， 所 以 ， 需 要 另外 集成 ，koa-generator 使 用 的 是 目前 比较 流行 的 
koa-router (我 喜欢 它 的 是 Express-style) 
https://github.com/alexmingoia/koa-router 
好 吧 


routes/users.js 


var router = require('koa-router')(); 
router.get('/:id', function *(next) ( 
console.log(this.params); 


console.log(this.request.params); 
this.body - 'this a users response! '; 


+); 


module.exports = router; 


npm run 2 


3$ llhttp://127.0.0.1:3000/users/alfred 
日 志 


«-- GET /users/alfred 
( id: 'alfred' ) 
undefined 
GET /users/alfred - 28 
首先 肯定 一 点 ，this.params 是 可 以 取 到 params 的 ， 这 点 和 express 路 由 用 法 类 似 


但 是 注意 的 是 


this.request.params !- this.params 


这 说 明 params 不 是 request 上 的 方法 ， 翻 查 源码 ， 确 实 是 如 此 


https://github.com/alexmingoia/koa-router/blob/5.x/lib/router.js#L317 


Post 


todo 


J post RE Zik 
Query # X 
F] Get € 4047 ¿query # 2% 


Params # 2 


同 Get 里 如 何 获取 params 参 数 


标准 表单 Post with x-www-form-urlencoded 
See public/post.html 


«script» 
$(function(){ 
$.ajaxSetup({ 
contentType: "application/x-www-form-urlencoded; charset=utf- 


+); 


$.post("/users/post", ( name: "i5a6", time: "2pm" >, 
function(data){ 
console.log(data); 
}, "json"); 


+); 


</script> 


E ES AAA 





in routes/users.js 


router.post('/post', function(req, res) ( 
// res.send('respond with a resource'); 
res.json(req.body); 


3); 
测试 
$ npm test 


使 用 Postman 测 试 


一 起 学 koa 


Normal «8» No environment v 


http://127.0.0.1:3001/users/post 


form-data x-www-form-urlencoded raw 


a 1 
b 2 
Key Value 
Key Value 


Preview Add to collection 





Body Will) 200 OK fil! |=) 32 ms 


Pretty Raw Preview O EK JSON 








"an, "Qu 


1 

2 : R 
3 "Br =o" 
4 


标准 表单 (Post with x-www-form-urlencoded) 


XML 


POST 


4» 
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文件 上 传 Post with form-data 


主要 目的 是 为 了 上 传 
koa-v1 要 是 用 koa-multer-v0.0.2 对 应 的 multer < 1， 所 以 本 处 需要 指定 版 本 安装 


$ npm install --save koa-multer@0.0.2 


Usage 


var app = require('koa')() 

koa = require('koa-router')() 
logger = require('koa-logger') 
json = require('koa-json' ) 
views = require('koa-views') 
onerror = require('koa-onerror'); 


~ ~ ~ ~ ~ 


var multer = require('koa-multer'); 


app.use(multer(( dest: './uploads/'))); 


You can access the fields and files in the request object: 


router.post('/post/formdata', function *(next) ( 
console.dir(this.req.body) 
console.dir(this.req.files) 

this.body = 'this a users response!'; 

+); 

重要 提示 : Multer will not process any form which is not multipart/form-data 

see more 


测 试 


$ npm test 


使 用 Postman 测 试 


一 起 学 koa 


Normal <> No environment v 
http://127.0.0.1:3001/users/post/formdata 


form-data x-www-form-urlencoded raw 











a 1 Text 
b 2 Text 
pic | Choose Files | 12.pic.jpg File 
Key Value Text 
Preview Add to collection 
Body 2000K (TI 46 ms 

Pretty Raw | Preview E gl JSON | XML 

1 { 

2 " a " : " T " n 

3 " b " : " 2 " 

4 ) 


x +E 4% (Post with form-data) 


POST 


4» 


4» 


4» 


4» 
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Post with raw(todo) 


To get the raw body content of a request with Content-Type: "text/plain" into 
req.rawBody you can do: 


https://gist.github.com/tj/3750227 
req.rawBody 已 经 被 干掉 了 ， 现 在 只 能 用 red.text 
下 面 是 tj 给 出 的 代码 片段 
var express = require('./') 
var app = express(); 
app.use(function(req, res, next){ 
if (req.is('text/*')) { 
req.text = ''; 
req.setEncoding('utf8'); 
req.on('data', function(chunk){ req.text += chunk }); 
req.on('end', next); 


) else { 
next(); 
} 


+); 


app.post('/', function(req, res){ 
res.send( 'got UU req.text + DIDP 


}); 
app.listen(3000) 
测试 


$ npm test 


使 用 Postman 测 试 


一 起 学 koa 


Normal «8$» No environment v 
http://127.0.0.1:3001/users/post/raw 


form-data | x-www-form-urlencoded raw JSON ~ 





T { 

2 "as Sd s 

3 "b": "er 

4 Sere 

5 " va u WA 
6 "bb" mam 
Z ] 

8 } 


Preview Add to collection 








Body 2000K Ki 38 ms 
Pretty Raw | Preview - E JSON | XML 
1| { 
2 " a "u : n 1 " A 
3 " b " : " 2 " 5 
4 " E " : 
5 u " : " 1 " j 
6 " b " : " 2 " 
7 } 
8 } 


Post with raw 


POST 
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db 


封装 思路 


koa 依 赖 co， 其 中 间 件 对 非 阻 塞 异 步 代 码 的 要 求 必 须 * Yieldables 7| & ¥ 的 形式 ， 而 
mysql 库 是 回调 函数 的 形式 。 因 此 ， 我 们 需要 进行 封装 ， 使 其 接口 符合 要 求 。 


目前 我 找到 了 四 种 方法 ， 前 三 种 使 用 开源 库 ， 第 四 种 自己 动手 ， 将 express 下 的 
dbHelper 层 封装 成 co 最 新 支持 的 Promise 形 式 。 


实现 方法 一 (co-mysq|l) 


co-mysql 和 mysql-co 实 现 了 对 mysq| 或 mysql2 的 封装 转化 。 这 两 个 库 的 思路 差 不 
多 ，mysql-co 封 装 度 更 高 ， 并 使 用 速度 更 快 的 mysql2 : 而 co-mysql 更 简单 ， 只 是 将 
mysql.query 封 装 成 Promise 形 式 。 下 面 是 基于 co-mysql 的 示例 代码 : 


var wrapper = require('co-mysql'), 
mysql = require('mysql' Ji 
var options = ( /* 数据 库 连 接 字 串 */ y; 


var pool = mysql.createPool(options), 
p = wrapper (pool); 


var rows - yield p.query('SELECT 1'); 
yield this.render('index', { 
title: rows[0].fieldName 
3); 


DO; 


实现 方法 二 (promisify-node ) 


使 用 promisify-node 库 ， 可 以 将 库 整 体 转化 为 Promise 形 式 ， 也 可 以 方便 的 转化 库 中 
的 指定 接口 函数 ， 示 例 代 码 如 下 


var promisify = require("promisify-node"); 
var db = promisify("dbHelper"); //express 下 的 回调 形式 封装 库 


var rows = yield db.getById('tableName', {id:1}); 
yield this.render('index', { 
title: rows[0].fieldName 
3); 


实现 方法 三 (thunkify ) 
使 用 thunkify 也 能 够 完成 封装 ，thunkify-wrap 是 一 个 增强 版 的 thunkify。 不 过 看 说 
明 ， 这 种 方法 在 未 来 的 发 展 中 可 能 会 被 淘汰 ， 大 概 的 使 用 方法 如 下 : 


var genify = require('thunkify-wrap').genify; 
var db = genify("dbHelper"); //eXpress 下 的 回调 形式 封装 库 
var rows = yield db.getById('tableName', {id:1}); 

yield this.render('index', { 


title: rows[0].fieldName 
3); 


实现 方法 四 (直接 方法 ) 


直接 改造 原来 express 下 的 回调 方式 代码 为 Promise 形 式 ， 代 码 及 说 明 如 下 : 
dbHelper.js 


var options = { /* 数据 库 连 接 字 串 */ y; 


var mysql - require('mysq1'); 
var pool - mysql.createPool(options); 


// 原 有 非 接 口 代码 ， 对 mysq1 的 封装 ， 执 行 Sql1 语 名 
function execQuery(sql, values, callback) { 
var errinfo; 
pool.getConnection(function(err, connection) { 
if (err) { 
errinfo = 'DB- 获 取 数 据 库 连接 异常 1 '， 
throw errinfo; 
) else { 
var querys = connection.query(sql, values, function(er! 
release(connection); 


if (err) { 
errinfo = 'DB-SQL 语 句 执 行 错误 :' + err; 
callback(err); 
) else { 
callback(null, rows); // 注 意 : 第 一 个 参数 必须 
} 


function release(connection) { 
try { 
connection.release(function(error) { 
if (error) { 
console.,10g('DB- 关 闭 数据 库 连接 异常 ! '); 
} 
3); 


) catch (err) {} 


} 
// 对 外 接口 代码 ， 包 装 成 返回 Promise 函 数 的 形式 
exports.getById = function(tablename, id)( 
return new Promise(function(resolve, reject){ 
var values = {id:id}; 


var sql - 'select * from ?? where ?'; 
execQuery(sql, [tablename, values], function(err, rows){ 
if(err){ 
reject(err); 
}else{ 


resolve(rows); 


} 
3); 











routes/index.js 


var db - require("../dbHelper"); 


var rows = yield db.getById('tableName', {id:1}); 
yield this.render('index', ( 
title: rows[0].fieldName 


+); 


代码 
示例 部 分 代码 取 自 该 项 目 : 


https://github.com/zhoutk/koadmin.git 


koa 框 架 以 co 库 为 核心 组 织 ， 很 好 的 用 generator 来 解决 了 回调 函数 问题 。 进 行 
Promise 接 口 形式 包装 的 时 候 ， 要 注意 : 回调 函数 要 完全 符合 其 要 求 的 形式 : 


function(err, rows){ 
if(err){ 
reject(err); 
}else{ 
resolve(rows); 
j 


}) 


mongodb 














ese 


[eee] + Les) 


CO (generator 4 promise) 


es7 


+ EJ 


http://www.ruanyifeng.com/blog/2015/05/async.html 


generator/co 


es6 的 generator 是 什么 ? 
generator4& #9 Æ 


function* xxx(){ 


} 


是 es6 里 的 写法 。 


function* test() { 
console.log('1'); 
yield 1; 
console.log('2'); 
yield 2; 
console.log('3'); 


代码 中 间 插 了 两 行 yield， 代 表 什 么 呢 ? 
e 当 test 执 行 到 yield 1 这 一 行 的 时 候 ， 程 序 将 被 挂 起 ， 要 等 待 执行 下 一 步 的 指 
a; 
e 当 接 收 到 指令 后 ，test 将 继续 往 下 运行 ， 直 到 yield 2 这 一 行 ， 然 后 程序 又 被 挂 
起 并 等 待 指令 ; 
e 收 到 指令 后 ，test 又 将 继续 运行 ， 而 下 面 已 经 没有 yield 了 ， 那 么 函数 运行 结 
束 。 


这 是 不 是 就 像 ， 我 们 调试 代码 的 时 候 ， 给 插 的 断 点 ? 
当然 ， 断 点 这 个 比喻 ， 只 是 表象 上 比较 相像 ， 实 质 原理 还 是 有 非常 大 差异 。 
yield 就 是 让 后 面 的 generator 执 行 完 成 后 ， 才 继续 往 下 走 。 


要 注意 ， 了 一 个 星 号 ， 这 样 是 表明 这 个 函数 将 K f 
数 ， 而 不 是 一 个 普通 函数 了 。 意 思 就 是 ，test 这 个 函数 ， 将 不 能 被 这 样 执行 


test(); 但 可 以 获得 一 个 生成 器 

var gen = test(); // gen 就 是 一 个 生成 器 了 然后 ， 生 成 器 可 以 通过 next() 来 执行 运行 
gen.next(); 

也 就 是 上 面 说 的 ， 让 函数 继续 运行 的 指令 。 

简单 地 总 结 一 下 : 


e 生成 器 通过 yield 设 置 了 一 些 类 似 " 断 点 “的 东西 ， 使 得 函数 执行 到 yield 的 时 候 会 
KH: 


e 生成 器 要 通过 next() 指 令 一 步 一 步 地 往 下 执行 (两 个 yield 之 间 为 一 步 ) ; 
e yield 语句 后 面 带 着 的 表达 式 或 函数 ， 将 在 阻 断 之 前 执行 完毕 ; 
e yield 语句 下 面 的 代码 ， 将 不 可 能 在 阻 断 之 前 被 执行 ; 


由 此 可 以 看 出 ，yield 是 如 何 将 异步 非 阻塞 代码 ， 变 成 异步 阻塞 代码 。 


CO 
理解 了 co 的 核心 代码 就 理解 了 koa 的 流程 控制 


var ctx = this; 
var args - slice.call(arguments, 1); 


一 开始 保存 上 下 文 ,把 arguments 的 length 属 性 去 掉 , 剩 余 的 参数 转 数 组 就 是 gen 的 参 
数 


再 来 看 return 的 promise 内 的 代码 


if (typeof gen === 'function') gen = gen.apply(ctx, args); 
if (!gen || typeof gen.next !-- 'function') return resolve(gen); 


先 判断 gen 是 不 是 generator function,» A X #44 A generator, 相当 
于 gen = new gen; 


4% A generator J& 3L T 438 A gen.next() T ; 


onFulfilled(); 


这 是 进入 循环 调用 链 的 入 口 


function onFulfilled(res) { 
var ret; 
try 
ret = gen.next(res); 
) catch (e) { 
return reject(e); 
} 


next(ret); 
} 
function onRejected(err) { 
var ret; 
try { 
ret = gen.throw(err); 
} catch (e) { 
return reject(e); 


next(ret); 
} 
function next(ret) { 
if (ret.done) return resolve(ret.value); 
var value = toPromise.call(ctx, ret.value); 
if (value && isPromise(value)) return value.then(onFulfilled, onf 
return onRejected(new TypeError('You may only yield a function, [ 
+ 'but the following object was passed: "' + String(ret.value) 


hi 





ret 是 gen.next 后 的 {value:"done:"} 对 象 ,value 是 yield 后 的 表达 式 ,done 是 执行 状态 . 


判断 ret.done 是 否 为 true 来 确定 是 否 需 要 再 执行 下 去 .为 true 时 ,说 明 已 经 是 generator 
的 最 后 一 步 ,promise 转 为 resolve. 不 为 true 时 ,将 yield 后 的 表达 式 转 化 为 promise. 


先 判 断 是 否 转 化 为 了 promise, 转 化 成 功 ,就 通 
过 value.then(onFulfilled, onRejected) 执行 onFulfilled 或 onRejected, 再 次 
调用 next(), 实 现 循环 调用 . 


当 value 不 能 转 为 promise 时 , 抛 出 错误 ,promise 转 为 reject, 停 止 继续 运行 . 


下 面 写 一 个 例子 简单 分 析 一 下 : 


var co = require('co'); 
vanetec-oreguiret fs 
function thunkRead(name) ( 
return function (cb) { 
fs.readFile(name, function (err, file) { 
cb(err, file); 
3); 
j 


co(tunctromnm *() T 
var file - yield thunkRead("package.json"); 
console.log(file); 
return file; 
}).then(function (file) 1 
console.log(file); 


+); 


通过 上 面 这 段 代 码 来 看 一 下 co 的 整个 流程 


先 模 拟 一 个 名 为 thunkRead 的 thunk 哆 数 ， 再 看 co 里 面 的 代码 ，CO 里 面 是 一 个 
generator function > gen = gen.apply(ctx, args); 通过 这 一 名 转化 为 了 
generator ° 


#3 AonFulfilled() & 2 > %—4gen.next() 2 a rete 
{ value: [Function], done: false } ##retf# Anext()P > done Z false > PT 
VAtoPromise > valuez=function > Pt vAthunkToPromise. 


function thunkToPromise(fn) { 
var ctx - this; 
return new Promise(function (resolve, reject) { 
fn.call(ctx, function (err, res) { 
if (err) return reject(err); 
if (arguments.length » 2) res - slice.call(arguments, 1); 
resolve(res); 
3); 
3); 
} 


A X fnxthunké&Z& » ZR ZAR — Ae EL HR, 
fn.call(ctx, function (err, res) {}); 直接 调用 resolve, 在 上 面 的 例子 中 
是 resolve(file); 


然后 回 到 next() 中 ， 此 时 已 经 是 一 个 promise 对 象 ， 调 用 value 的 then 方 法 ， 
onFulfilled 的 参数 就 是 file， 再 运行 gen.next(file)， 将 上 一 步 yield 的 结果 file 传 入 
generator， 因 为 在 例子 中 最 后 return 了 file, ret 是 

( value:<Buffer ...>, done: true ) 最 后 不 返回 值 的 话 应 该 是 

{ value: undefined, done: true } ,再 进入 到 next() 中 ， 此 时 done 已 经 为 
true， 说 明 已 经 是 generator 的 最 后 一 步 ，resolve(value); 


co 中 的 代码 已 经 执行 结束 ， 因 为 co 也 是 一 个 promise, 最 后 resolve(value)， 所 有 可 
以 在 then 方 法 中 得 到 这 个 value. 


补充 下 toPromise 支 持 转 化 thunks,array,objects,generators,generator functions. 
所 以 可 以 yieldable 的 是 以 下 6 种 : 


promises 

thunks (functions) 

array (parallel execution) 
objects (parallel execution) 
generators (delegation) 
generator functions (delegation) 


async/await 


promise with bluebird 


test 


mocha 


supertest 


deploy 


faq 


gitbook X 7p 1% A 


A +i VAgitbookA #44 25 > 24% 2 git pages 上 ， 为 了 便于 大 家 使 用 ， 请 按照 如 下 办 法 


TF A&gitbook/& #4 35 
https://www.gitbook.com/editor 


生成 html 


gitbook -> Book -> Preview Website 


€  GitBook File Edit Window ENS Preferences Develop Help 14% 9 & I5 > 


eoe 
3.2.3. Post with form-data 


3.2.4. Post with raw 
3.3. Upload 
4. 数据 库 
4.1. MySQL 
4.2. Mongo 
5. 流程 控制 
5.1. generator/co 


5.1.1. es6 的 generator 是 什 
4? 


5.1.2. co = generator + 
promise 


5.2. async/await 
5.3. promise with bluebird 
6. 测试 
6.1. Mocha 
6.2. Supertest 
7. 部 署 
8. 最 佳 实践 
9. FAQ 


9.1. 如 何 知道 require 模 块 的 用 法 


发 布 到 git pages 上 


gulp deploy 


预览 并 确认 


| 


通 


Save all koa-generator-examples - GitBook Editor 





Publish As... 2 I3 14 = = B 


Add Chapter 
Set Cover Picture 


Languages > 
Edit Configuration 


Preview Website 


Build Website As... 小 漏 ， 提 供 更 多 最 佳 实践 
Build PDF As... 


Build eBook (EPUB) As... 
Build eBook (MOBI) As... 


过 提问 、 实 现 ，pr 的 方式 


#issue 

根据 某 个 issue，fork 并 实现 
提交 pr 

合并 pr 并 发 布 


## 版 本 说 明 


README .md 放 说 明和 实现 规范 
- 1.x.md 放 koal.x 版 本 的 用 法 
- 2.x.md 放 koa2.x 版 本 的 用 法 


# koajs 1.x 和 2.x 的 区 别 


1.x 和 2.x 的 都 是 基于 ctx (上 下 文 ) 模型 实现 的 


目前 2.x 还 没 没有 完全 定 下 来 


nodejs 4.0+ 支 持 的 es6 语 法 
async/await x $$ 
generator 不 能 直接 使 用 ， 必 须 使 用 co 类 的 包装 后 才 可 以 


# 目录 


访问 http://base-n.github.io/koa-generator-examples/ 





204741 3á require 2X 49 71] 7 
比如 

var router = require('koa-router')(); 
打开 
https://www.npmjs.com/search?q-koa-router 


找到 


https://www.npmjs.com/package/koa-router 


koa? 89 Jr 5$ Ab 39 


比如 router 中 某 个 yield 可 能 抛 错 ， 这 种 情况 下 要 返回 请 求 是 怎么 做 的 呀 ， 都 是 直接 
在 app on error 里 面 处 理 吗 


在 route 里 


co(function* () { 
var result = yield Promise.resolve(true); 
return result; 

}).then(function (value) { 
console.log(value); 

+, function (err) { 
// EAE 
console.error(err.stack); 


+); 


